home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 3 / Info_Mac_1994-01.iso / Communications / Information / ZTerm 0.9 FAQ 1.5 < prev   
Internet Message Format  |  1993-12-30  |  72KB
  1. Date: Wed, 27 Oct 1993 22:53:43 -0400 (EDT)
  2. From: Les Jones <LJONES@UTKVX.UTCC.UTK.EDU>
  3. Subject: ZTerm 0.9 FAQ 1.5
  4.  
  5. This is the ZTerm 0.9 FAQ, version 1.5, dated October 27, 1993.
  6.  
  7. The FAQ answers frequently asked questions (FAQs) about ZTerm, and 
  8. includes undocumented tips, ResEdit hacks, bug reports, and
  9. bug fixes. Please read this FAQ before sending questions about
  10. ZTerm to ZTerm author Dave Alverson or to comp.sys.mac.comm.
  11.  
  12. Changes since the last version:
  13.  
  14. o  News: the $99 14400 bps LineLink modem
  15. o  News: new ZModem CTB tools available
  16. o  News: Crosstalk 2.0 for Macintosh
  17. o  News: Communicate Lite demo with the Apple Modem Tool 1.5
  18. o  Tip:  adding a separator line to the Dial menu
  19. o  Tip:  changing ZTerm's terminal font with ResEdit
  20. o  Q:    how do I do ZModem uploads to Delphi?
  21. o  Q:    Why is my transfer efficiency so low?
  22.  
  23. My Internet account will change soon. Please direct email to
  24. lesliejonz@aol.com.  --Leslie Jones  
  25.  
  26.  
  27.   
  28.   
  29.   
  30.   
  31.   
  32.                                   ZTerm 0.9 FAQ
  33.                                  by Leslie Jones
  34.   
  35.                                    Version 1.5
  36.                             updated October 27, 1993
  37.   
  38.   
  39.   
  40.   
  41.   
  42.                    For best results, display in 9 point Monaco
  43.                            with rulers set to 7 inches.
  44.   
  45.   
  46.   
  47.   
  48.   
  49.                                  ZTerm News
  50.   
  51.   
  52.                 The TCI LineLink 144e: 14400 bps for $99?
  53.   
  54.   The networks have been buzzing about the "$99 modem." For the first
  55.   time, Mac users can buy a 14400 bps Macintosh modem for under one
  56.   hundred dollars. Though unable to test the modem firsthand, I was
  57.   able to collect a great deal of information from the
  58.   comp.sys.mac.comm newsgroup, reports in the Info-Mac Digest, and
  59.   sales and technical support representatives from MacWAREHOUSE,
  60.   which is the sole distributor of the modem.
  61.   
  62.   Details
  63.   An external modem, the TCI LineLink 144e costs $99.00 and includes
  64.   MacKNOWLEDGE data software, a hardware handshaking cable, and an
  65.   AppleTalk Remote Access script. The modem can send and receive
  66.   faxes and data at 14400 bps. CCITT protocols supported include
  67.   V.42, V.42bis, V.32, and V.32bis. Supports MNP levels 1-5. The
  68.   LineLink uses the Sierra chipset. Order part number BND0249 from
  69.   MacWAREHOUSE (1-800-255-6227).
  70.   
  71.   What's missing
  72.   *Fax software. MacWAREHOUSE offers a MaxFax upgrade for $29.00. The
  73.   Mac Zone sells essentially the same modem under the Performantz
  74.   label for $144.98, which includes MaxFax, MacKNOWLEDGE, and a
  75.   cable, though a Mac Zone representative was unable to confirm
  76.   whether the cable was capable of hardware handshaking, or whether
  77.   an ARA script was included. Order part number 99322 from Mac Zone
  78.   (1-800-436-8000). Several people report successfully configuring
  79.   FAXstf to work with the LineLink. When configuring FAXstf, remember
  80.   that the LineLink uses the Sierra chipset.
  81.   *Decent data software. MacKNOWLEDGE users describe it as barely
  82.   serviceable. Most users will want to download Dave Alverson's
  83.   shareware ZTerm 0.9 or buy a commercial program.
  84.   *Decent documentation. The manual is a scant 28 pages and lacks
  85.   documentation for some of the AT commands and S-registers. Luckily,
  86.   a file exists which documents all of the LineLinkss S-registers.
  87.   Look for the file on America Online or at sumex-aim.
  88.   *Decent tech support. The sales reps and technical support people I
  89.   talked to had never heard of a hardware handshaking cable. The
  90.   response to most problems seems to be "Send the modem back and
  91.   we'll replace it."
  92.   *Separate incoming and outgoing LEDs. If you have an Apple Extended
  93.   Keyboard, there's a software solution for this shortcoming.
  94.   Download John Stephen's MacLights 1.02a control panel, which can
  95.   use the num lock, caps lock, and scroll lock LEDs to indicate
  96.   receive, send, carrier (GPI), handshaking in (CTS/DSR), and
  97.   handshaking out (RTS/DTR). MacLights can also report floppy disk,
  98.   hard disk, and SCSI port activity. Highly recommended for extended
  99.   keyboard owners.
  100.   
  101.   PC compatibility
  102.   Like all external Hayes-compatible modems, the LineLink can be
  103.   outfitted with an adapter cable and used with an IBM-compatible PC.
  104.   The necessary cable is available from most mail order houses.
  105.   MacWAREHOUSE's PC sister company, MicroWarehouse (1-800-367-7080),
  106.   sells the LineLink modem with a PC cable and PC data software for
  107.   $99.95 as part number MM3270.
  108.   
  109.   For use with a PC, set the modem to &R0. &R1 is the Mac setting.
  110.   Some Mac users have received modems set to the PC setting of &R0.
  111.   If you have any trouble with your modem, send it an AT&V command to
  112.   display all settings. If &R0 is set, change it to &R1.
  113.   
  114.   Reliability
  115.   Judging from reports on the networks, LineLinks work fine for some
  116.   users and poorly for others. This is true for all modems, but the
  117.   LineLinks have more than their share of problems. A number of
  118.   people on Usenet have returned defective modems one or more times
  119.   before getting a reliable modem. Luckily, MacWAREHOUSE will replace
  120.   defective units at their expense, though the warranty is limited to
  121.   30 days.
  122.   
  123.   Recommendation
  124.   For modem hobbyists on a budget, the LineLink is a great value,
  125.   with two caveats. First, expect to spend some time monkeying with
  126.   the AT settings. Second, test the modem thoroughly when it arrives.
  127.   In particular, make sure it can connect at speeds higher than 9600
  128.   bps; an inability to connect at 14400 bps seems to be the biggest
  129.   problem owners have. If you find any problems whatsoever, contact
  130.   MacWAREHOUSE immediately and order a replacement.
  131.   
  132.   For business use, this modem is a gamble. It might work fine or it
  133.   might fail at the most inconvenient time. If your business depends
  134.   on its modem for email and faxes, consider investing in a more
  135.   reliable model.
  136.   
  137.   
  138.   
  139.                            CTB Zmodem Tools Arrive
  140.   
  141.   As predicted in last month's ZTerm FAQ, several new ZModem tools
  142.   arrived this month. The first was the long-awaited tool from
  143.   SeaQuest. 
  144.   
  145.   The second was a shocker. DCA has released a Macintosh version of
  146.   Crosstalk, a communications package formerly available only for the
  147.   PC. According to MacWEEK (10.11.93), Crosstalk will use the
  148.   Communications Toolbox and will support XModem, YModem, ZModem,
  149.   Kermit, CompuServe QuickB, IND$FILE, and FTTERM. Terminal emulation
  150.   includes PC ANSI, VT320, ADDS Viewpoint+, HP 700/94, Wyse 50 and
  151.   Televideo 950. Apple's VT102 tool is presumably included as well,
  152.   though this is not confirmed. Owners of the PC version or of
  153.   competing Mac products can upgrade for $49. Contact Digital
  154.   Communications Associates at (404-442-4000).
  155.   
  156.   Aladdin's SITcomm is still in beta, but will include XModem,
  157.   YModem, ZModem, and Kermit tools. SITcomm's most interesting
  158.   features are the ability to convert many file formats on the fly
  159.   during uploading and downloading, and the ability to use
  160.   AppleScript and Frontier to automate online sessions.
  161.   
  162.   The next version of Communicate Lite will include a ZModem tool,
  163.   and will be a free upgrade for current users. The ZModem tool is
  164.   currently in beta.
  165.   
  166.   
  167.                           Communicate Lite Demo Available
  168.   
  169.   A demo version of Mark/Space Softworks' Communicate Lite is
  170.   available from America Online and via anonymous FTP from netcom.com
  171.   in the directory mspace/pub. The demo includes the just-released
  172.   Apple Modem Tool 1.5. For the time being, downloading the
  173.   Communicate Lite demo may be the easiest way to obtain the new
  174.   Apple Modem Tool. 
  175.   
  176.   One outstanding feature of Communicate Lite is the ability to open
  177.   multiple simultaneous communications sessions. Communicate Lite's
  178.   interface is extremely clean. The demo lacks the full version's
  179.   ability to open or save session settings, but is fully functional
  180.   otherwise. The full version of Communicate Lite is available for
  181.   $49.95 plus shipping and handling from Mark/Space Softworks
  182.   (408-982-9781). Internet: mspace@netcom.com; AppleLink, AOL:
  183.   markspace. Look for the demo on America Online, or FTP into
  184.   netcom.com and look in the directory mspace/pub.
  185.   
  186.   
  187.   
  188.     Contents:
  189.   
  190.   ! = New section!
  191.   + = Section updated since the last version of the FAQ
  192.   
  193. + Distribution and Posting Information
  194. + Credits
  195.   Copyright Notice and Trademarks
  196.   Disclaimer
  197. + Contacting the Author
  198.   Other ZTerm Information and Software
  199.   
  200.   [1] ZTerm's Version History
  201.   
  202.   [1.1]  What's the current version?
  203.   [1.2]  What features will be in the next version?
  204.   [1.3]  When will the next version be released?
  205.   
  206.   
  207.   [2] Registration and Support
  208.   
  209.   [2.1]  Why should I register (pay the shareware fee)?
  210.   [2.2]  Will I get technical support if I register?
  211.   [2.3]  If I registered an earlier version of ZTerm, do I have to
  212.          send in an upgrade fee?
  213.   [2.4]  What is Dave's new Internet address?
  214.   
  215.   
  216.   [3]    Quick Fixes for Common Problems
  217.   
  218.   [3.1]  Relax. Don't worry. Have a homebrew.
  219.   [3.2]  Select a download folder to prevent -120 downloading error.
  220.   [3.3]  Make sure ZTerm is sending data to the correct port.
  221.   [3.4]  Make sure call waiting is disabled.
  222. + [3.5]  Make sure you have a hardware handshaking cable.
  223.   [3.6]  Install Apple's Hardware System Update 2.0.
  224.   [3.7]  Quit other programs which use the modem.
  225.   [3.8]  Turn the modem off, wait a few seconds, then turn it
  226.          back on.
  227.   [3.9]  Quit ZTerm, then relaunch ZTerm.
  228.   [3.10] Restart the computer.
  229.   [3.11] Restart the computer with extensions off.
  230.   [3.12] Disable fax software and fax auto-answer.
  231.   [3.13] Move the ZPhoneList out of the ZTerm folder.
  232.          (But don't throw it away!)
  233.   
  234.   
  235.   [4] Known Bugs, ResEdit Fixes, and ResEdit Hacks
  236.   
  237.   [4.1]  Queue dialing
  238.   [4.2]  File appends
  239.   [4.3]  Missing download folder
  240.   [4.4]  UNIX and Opus settings
  241.   [4.5]  Sending returns in scripts
  242.   [4.6]  Text pacing
  243.   [4.7]  Unmarking all services
  244.   [4.8]  Dialing with the scroll buffer scrolled back
  245. ! [4.9]  Non-bugs
  246.   [4.10] Increasing the port buffer size with ResEdit
  247.   
  248.   
  249.   [5] Dialing
  250.   
  251.   [5.1]  Why is one service in the Dial menu and in the Dial
  252.          directory in outline?
  253.   [5.2]  I started ZTerm and the only service listed is called
  254.          Local.  Wa' hoppen?
  255.   [5.3]  My ZPhoneList with a kajillion phone numbers and settings
  256.          got trashed.  Am I screwed?
  257.   [5.4]  Why won't ZTerm send my modem initialization string?
  258.   [5.5]  Using multiple ZPhoneLists.
  259.   [5.6]  Undocumented tip: changing the data rate.
  260.   [5.7]  Undocumented tip: changing parity, data bits, and stop bits.
  261.   [5.8]  Undocumented tip: dialing the current service.
  262. ! [5.9] Undocumented tip: adding a separator line to the Dial menu.
  263.   
  264.   
  265.   [6]    Connecting
  266.   
  267. + [6.1]  When ZTerm dials, the dialing line has the A cut off the
  268.          dial string, like this: TDT 691-7094.  Tell me, tell me!
  269.          Whatever could be wrong?
  270.   [6.2]  Why is ZTerm so slow at sending passwords on some
  271.          services?
  272.   [6.3]  Why isn't there a setting for 14400 bps?
  273.   [6.4]  What data rate should I use with a 14400 bps modem?
  274.   [6.5]  Why can't I connect at 14400 bps?
  275.   [6.6]  How can I prevent my modem from constantly dropping carrier?
  276. + [6.7]  Why won't my modem hangup?
  277.   
  278.   
  279.   [7] File Transfers
  280.   
  281.   [7.1]  This text, binary, MacBinary, and Smart MacBinary stuff
  282.          makes my head spin.  Which should I use?
  283.   [7.2]  When I download Mac files from a PC BBS, the files have
  284.          generic icons and are unusable.  What went wrong?
  285.   [7.3]  Which protocol should I use?
  286.   [7.4]  Does ZTerm support batch ZModem downloads?
  287.   [7.5]  Interrupting ZModem downloads is messy.  What's a modem
  288.          freak to do?
  289.   [7.6]  Can I use ZModem from my VAX account?
  290.   [7.7]  How do I prevent massive CRC errors during ZModem
  291.          downloads from UNIX?
  292.   [7.8]  I have other transfer problems with UNIX.  What's Dave
  293.          been smokin'?
  294.   [7.9]  I have an error-correcting modem.  Which protocol should I
  295.          use?
  296. ! [7.10] Why can't I do ZModem uploads to Delphi?
  297.   [7.11] Where's YModem-G Send?
  298.   [7.12] Why does YModem work on some systems and not others?
  299.   [7.13] Using hardware compression makes my uploads and downloads
  300.          slower.  Wie gehts?
  301. + [7.14] If I have the Kermit/VT102/etc. Tool, will ZTerm support
  302.          Kermit/VT102/etc.?  Are any ZModem tools available?
  303.   [7.15] How can I resume downloads interrupted by a meddling
  304.          cat?
  305. ! [7.16] Hellfire tarnation and a monkey! Why's my transfer
  306.          efficiency so low?
  307.   
  308.   
  309.   [8] Sound, ANSI Graphics, and Color
  310.   
  311.   [8.1]  Why oh why won't the ZTerm sounds play?
  312.   [8.2]  Can I use sounds other than the ones that come with ZTerm?
  313.   [8.3]  Is there any limit on the length of the sounds?
  314.   [8.4]  How do I turn my modem speaker down or off?
  315.   [8.5]  Why can't women see what a great guy I am?
  316.   [8.6]  How do I get ANSI graphics when connecting to a PC BBS?
  317.   [8.7]  I did all of that and the ANSI graphics still look a
  318.          little funny.  What gives?
  319.   [8.8]  How can I add excitement to my dull and monotonous
  320.          existence?
  321.   
  322.   
  323.   [9] VT100 Emulation
  324.   
  325.   [9.1]  I'm wiggin' out, Leslie.  Why don't the home, end, page
  326.          up, and page down keys on my extended keyboard work?
  327.   [9.2]  Why don't the f1-f4 editing keys on my extended keyboard
  328.          work?
  329.   [9.3]  How can I emulate a control key on a Mac Plus?
  330.   [9.4]  How can I emulate an escape key on a Mac Plus?
  331.   [9.5]  How can I emulate a numeric keypad on a PowerBook?
  332.   [9.6]  Undocumented tip: positioning the cursor with the mouse.
  333.   
  334.   
  335.   [10] Text and Text Files
  336.   
  337.   [10.1] Can I make the terminal font bigger?
  338.   [10.2] Why does onscreen text look so crummy in anything but 9 or
  339.          12 point?
  340.   [10.3] Will ZTerm save text files in something other than
  341.          TeachText?
  342.   [10.4] How can I increase the size of the scroll buffer?
  343.   [10.5] Why do some characters get corrupted when I copy text from
  344.          my word processor and paste it into ZTerm?
  345. ! [10.6] Undocumented tip: changing the terminal font with ResEdit.
  346.   
  347.   
  348.   [11]   Macros and Scripting
  349.   
  350.   [11.1] How do I know the script is running?
  351.   [11.2] How do I cancel a script?
  352.   [11.3] How do I send an escape/linefeed/etc. in a script?
  353.   [11.4] Does a ^M have to be in quotation marks?
  354.   [11.5] Do I have to use the Wait for "da da da" prompt syntax?
  355.   [11.6] Why is ZTerm sending only part of a line?
  356.   [11.7] How can I send quotation marks within a send statement?
  357.   [11.8] What does error -49 mean?
  358.   [11.9] I'm goin' nuts! Why won't my login script run?
  359.   [11.10]Login script example.
  360.   [11.11]Undocumented tip: sending a sig with a script and macro.
  361.   [11.12]Other uses of scripts and macros
  362.   
  363.   An Easter Egg
  364.   
  365.   
  366.   
  367.   
  368.   Distribution and Posting Information
  369.   
  370.   America Online
  371.   I always send the current version to America Online.  Use File
  372.   Search keyword "zterm".
  373.   
  374.   FTP
  375.   I will also send the current version to
  376.   macgifts@mac.archive.umich.edu, a mail exploder which delivers the
  377.   file to the sumex-aim and umich FTP sites, as well as other,
  378.   lesser-known  FTP sites.  The following list shows the location of
  379.   the FAQ at various FTP sites, along with the appropriate
  380.   directories.  Sumex and umich are two primary FTP sites.  The other
  381.   sites mirror the contents of either sumex or umich.  The mirrors
  382.   are often easier to access, especially during business hours.  Note
  383.   that the archie.au site is in Australia and that src.doc.ic.ac.uk
  384.   is in the United Kingdom.  To conserve limited Internet resources,
  385.   use the site closest to home.
  386.   
  387.            FTP site                                Directory
  388.   
  389.   sumex-aim.stanford.edu                           
  390.   info-mac/comm/info
  391.   wuarchive.wustl.edu                      
  392.   mirrors/info-mac/comm/info
  393.   archie.au                             
  394.   micros/mac/info-mac/comm/info
  395.   mac.archive.umich.edu                        
  396.   mac/misc/documentation
  397.   wuarchive.wustl.edu
  398.   mirrors/archive.umich.edu/mac/misc/documentation
  399.   archie.au                   
  400.   micros/mac/umich/mac/misc/documentation
  401.   src.doc.ic.ac.uk          
  402.   packages/mac/umich/mac/misc/documentation
  403.   
  404.   Online services
  405.   The only commercial service I send the FAQ to is America Online . 
  406.   If you belong to another online service, I would appreciate it if
  407.   you would upload the FAQ there. Note to Delphi users: if you have
  408.   trouble uploading using ZModem, try switching from rz to uz in
  409.   ZTerm's Zmodem Options.
  410.   
  411.   Usenet
  412.   Each month I will post the current version of the FAQ to the
  413.   comp.sys.mac.* Usenet newsgroups, where * is apps, comm, hardware,
  414.   and portables.
  415.   
  416.   Email
  417.   Harris Upham has generously volunteered to provide the FAQ via
  418.   email.  He requests that you put "ZTerm" somewhere in the subject
  419.   line so he can easily identify FAQ requests.  Harris is being very
  420.   generous with his time.  Please mail him only if you can't get the
  421.   FAQ by other means.  The address is hupham@fscvax.fsc.mass.edu.
  422.   
  423.   
  424.   Credits and Thanks
  425.   
  426.   Many thanks to the folks who have contributed, knowingly or
  427.   unknowingly.  While compiling this FAQ, I was often helped by the
  428.   net community, particularly readers of the Usenet newsgroup
  429.   comp.sys.mac.comm and the Info-Mac Digest.  Thanks to all the
  430.   helpful people out there in netland!  In rough chronological order:
  431.   Neil Schulman, Joe Dellwo, Adam Toner, Rick McCormack, Scott
  432.   Macrae, David Platt, Daniel Friedan, Drew Wade, Gregory Youngs, Roy
  433.   Wood, Gary Snow, Peter Middleton, Eric Hoffmann, Jay Bourland, Pete
  434.   Halverson, Henri Schueler, Miles Abernathy, Jeff Kwan, Kent
  435.   Ritchie, Davey Silon, David Ray, Walter Ian Kaye, Harris Upham,
  436.   Shigeru Yamamoto and Julian Vrieslander.  Others have contributed
  437.   material which I may use in upcoming versions of the FAQ.
  438.   
  439.   Special thanks to ZTerm author Dave Alverson for providing
  440.   information about the next release, and for releasing a great piece
  441.   of software as shareware.
  442.   
  443.   
  444.   Copyright Notice and Trademarks
  445.   
  446.   This document is copyright 1993 by Leslie Jones.  All rights
  447.   reserved.  I ask for no money, but please give credit when quoting
  448.   information in this document.  Crediting the FAQ will make others
  449.   aware of its existence.  Unmodified copies of this document may be
  450.   freely copied and distributed electronically, and may be uploaded
  451.   to FTP sites which allow anonymous login, nonprofit BBSs, and
  452.   commercial online services which charge no more than a normal
  453.   connect fee for downloading files.
  454.   
  455.   For-profit distribution on physical media, including but not
  456.   limited to paper, floppy disk, and CD-ROM, is prohibited without
  457.   written permission.  Explicit permission is granted to the
  458.   moderators and archivists of the sumex-aim archives to include this
  459.   document on the info-mac CD-ROM.  Explicit permission is also
  460.   granted to nonprofit user groups registered with Apple to
  461.   distribute this document on their disk of the month.
  462.   
  463.   This document contains the names of trademarked products.  The
  464.   trademarks are the property of their respective owners, and are
  465.   used here only in an editorial capacity.
  466.   
  467.   Disclaimer
  468.   
  469.   This document is a volunteer effort.  Every attempt has been made
  470.   to provide accurate information, but the author and contributors
  471.   accept no responsibility for actions resulting from the use of this
  472.   free information.  This document is provided as is with no warranty
  473.   of any kind.
  474.   
  475.   
  476.   Contacting the Author
  477.   
  478.   In preparation for a change of Internet accounts, I'm changing my
  479.   preferred mail address.  To make corrections and suggestions, send
  480.   Internet mail to lesliejonz@aol.com, or send America Online mail to
  481.   LeslieJonz.  If mail to that address bounces, send Internet mail to
  482.   ljones@utkvx.utk.edu.  UTK is the University of Tennessee,
  483.   Knoxville, the land of the free and the home of the Vols.
  484.   
  485.   
  486.   
  487.   
  488.   Other ZTerm Information and Software
  489.   
  490.   Information
  491.   
  492.   This FAQ answers questions relating specifically to ZTerm 0.9. 
  493.   There are other sources for information of interest to ZTerm users.
  494.   
  495.   General communications
  496.   For answers to more general questions about Macintosh
  497.   telecommunications and networking, please read Eric Rosen's
  498.   excellent comp-sys-mac-comm FAQ, available for anonymous FTP from
  499.   sumex-aim.stanford.edu and mac.archive.umich.edu.  Everyone who
  500.   uses a modem should keep Eric's FAQ on their hard drive.
  501.   
  502.   File conversion
  503.   For answers to questions about file conversion ("I downloaded a
  504.   file that ends in cpt/sit/dd/arc/lzh/pit/etc.  How do I open it?"),
  505.   get David Lemson's exhaustive report compression-util-table.  The
  506.   ZTerm manual briefly describes the most common Macintosh
  507.   compression formats.
  508.   
  509.   Modem configuration
  510.   For information about configuring your modem, consult your modem's
  511.   manual.  I address specific problems in the FAQ, but there really
  512.   is no substitute for a working knowledge of the Hayes command
  513.   language.  When your AT command reference is torn at the edges and
  514.   soiled with the dirt of your hands, it is then you will know you
  515.   have mastered the art of telecommunications.
  516.   
  517.   Usenet
  518.   If you have Usenet access, questions about Macintosh-specific
  519.   telecommunication hardware and software should be directed to
  520.   comp.sys.mac.comm.  Questions about modems and telecommunications
  521.   in general should be directed to comp.dcom.modems.  I often read
  522.   c.s.m.comm and answer questions about ZTerm by searching for the
  523.   string "zt."  If you post there, please spell ZTerm correctly.  It
  524.   is NOT spelled Z-term.  (Personal rant mode *off*.)  Actually,
  525.   after reading this FAQ, you'll probably be answering ZTerm
  526.   questions, not asking them.
  527.   
  528.   
  529.   Software
  530.   
  531.   ZTerm Phone Directory Listing
  532.   Denise McElroy (dmcelroy@bonnie.ics.uci.edu) released this
  533.   application, which reads your ZPhoneList file and produces a text
  534.   file containing the names and phone numbers of all services.  If
  535.   your ZPhoneList ever gets erased or corrupted, you'll be glad you
  536.   used it.  This application may be also able to extract the phone
  537.   numbers from a corrupted ZPhoneList.
  538.   
  539.   ZTerm High Speed Patch
  540.   Jon Snell (jonsnell@aol.com) wrote a 16 color palette resource and
  541.   ResEdit instructions for installing the palette.  By using the hack
  542.   and setting the monitor depth to 16 colors, ZTerm users will
  543.   experience faster screen redraws while still seeing the correct
  544.   colors.  Users with 2400 bps modems will experience little or no
  545.   speed increase.  In my experience, the patch makes ZTerm faster in
  546.   16 colors, but a little slower in 256 colors.  Highly recommended
  547.   if you normally use 16 color video.
  548.   
  549.   Star Trek sounds
  550.   Star Trek fans now have their own sounds for ZTerm!  The sounds are
  551.   available on America Online as M's ZSounds, and at sumex-aim as
  552.   star-trek-comm-sounds in the info-mac/snd directory.  These are the
  553.   coolest ZTerm sounds I've used.  The sounds are as follows:
  554.   
  555.   Connect:   Worf saying "Link established.  Receiving."
  556.   Filedone:  Worf saying "Transfer of information complete."
  557.   Termbell:  Enterprise computer beep.
  558.   
  559.   
  560.   
  561.   
  562.   [1]    ZTerm's Version History
  563.   
  564.   [1.1]  What's the current version?
  565.   
  566.   ZTerm 0.9 is the current version.  It is dated February 8, 1992.
  567.   Before 0.9 was released, someone hacked 0.85 with ResEdit and
  568.   released it as 1.0.  There is a more recent hack called 0.93 XK
  569.   (eXtra Keys), which was released by a user group.  Anyone may
  570.   modify ZTerm with ResEdit for their personal use, but distributing
  571.   modified versions of copyrighted software is illegal.  If you
  572.   discover an interesting ResEdit hack, send it to me and I'll
  573.   publish it in the FAQ.
  574.   
  575.   Dave Alverson sends official releases to America Online,
  576.   CompuServe, and GEnie.  You can also expect the newest version to
  577.   appear quickly on BBSs and FTP sites.
  578.   
  579.   [1.2]  What features will be in the next version?
  580.   
  581.   Support for Kermit file transfers.
  582.   
  583.   Implementation of 16 color ANSI graphics, instead of the current 8
  584.   colors.
  585.   
  586.   Some additions to the scripting language.
  587.   
  588.   A scripts folder, possibly.
  589.   
  590.   Bug fixes.
  591.   
  592.   [1.3]  When will the next version be released?
  593.   
  594.   The original goal was second quarter, 1993, conditional on Dave
  595.   finding enough spare time.  That date has now passed.  We all hope
  596.   the next version will appear Real Soon Now.
  597.   
  598.   
  599.   [2]    Registration and Support
  600.   
  601.   [2.1]  Why should I register (pay the shareware fee)?
  602.   
  603.   This is a tough question. There is no legal precedent to show that
  604.   people can be forced to pay for shareware, so one will come
  605.   knocking on your door in the middle of the night.  On the other
  606.   hand, many of us in the computer community feel that you should pay
  607.   for shareware which you use often, just because it seems to us to
  608.   be the right thing to do.  Shareware authors put a lot of work into
  609.   their software, and they deserve compensation.  Shareware authors
  610.   also put a lot of faith in the computer community by releasing
  611.   their products as shareware.  They trust that people will
  612.   voluntarily pay for a product they need and use.  I for one don't
  613.   think we should take advantage of people's trust.
  614.   
  615.   There are also practical reasons for registering.  Registering
  616.   encourages the author to update his software.  More importantly,
  617.   the author is more likely to continue to release his work as
  618.   shareware if people pay the registration fee.
  619.   
  620.   The copy of ZTerm which ships with some Global Village modems has
  621.   been paid for by the nice people at Global Village, who know a good
  622.   piece of software when they see it.
  623.   
  624.   [2.2]  Will I get technical support if I register?
  625.   
  626.   Yes.  Dave supports ZTerm through paper mail, email, and in
  627.   conferences on America Online, CompuServe, and GEnie.  The
  628.   locations of the conferences are listed in the Support dialog under
  629.   the Misc menu.  Registered users receive his home phone number and
  630.   can call him for direct phone support.  When was the last time you
  631.   called a Microsoft programmer at home?
  632.   
  633.   If you send Dave a question, include the registration number you
  634.   received when you registered ZTerm, as Dave almost certainly gives
  635.   priority to registered users.
  636.   
  637.   Global Village handles technical support for the Global Village
  638.   version of ZTerm.
  639.   
  640.   [2.3]  If I registered an earlier version of ZTerm, do I have to
  641.          send in an upgrade fee?
  642.   
  643.   No.  Dave Alverson, like most shareware authors, doesn't charge
  644.   upgrade fees.  This is another advantage of shareware.
  645.   
  646.   [2.4]  What is Dave's new Internet address?
  647.   
  648.   The address given in ZTerm 0.9 is out of date.  Dave's new Internet
  649.   address is davea@xetron.com, and is his preferred mail address.
  650.   
  651.   
  652.   [3]    Quick Fixes for Common Problems
  653.   
  654.   [3.1]  Relax. Don't worry. Have a homebrew.
  655.   
  656.   Keep your head tool cool.  Read the manual, read this FAQ, and
  657.   remember that tens of thousands of people have used ZTerm
  658.   successfully.
  659.   
  660.   Before you use ZTerm for the first time:
  661.   
  662.   [3.2]  Select a download folder to prevent -120 downloading error.
  663.   
  664.   Before downloading files for the first time, you must select a
  665.   default download folder by selecting Receive Folder from the
  666.   Settings menu.  If you can upload files but can't download them,
  667.   you probably haven't selected a receive folder.  Remember to select
  668.   a new folder when moving to a new computer.
  669.   
  670.   [3.3]  Make sure ZTerm is sending data to the correct port.
  671.   
  672.   An external modem can be connected to the modem or printer ports.
  673.   Find out which yours is attached to, select Modem Preferences from
  674.   the Settings menu, and select the port.  Alternatively, you can
  675.   hold down the shift key while ZTerm loads to select the port.  If
  676.   you have a PowerBook with an internal modem, open the PowerBook
  677.   control panel and select the option for an internal modem.
  678.   
  679.   All things being equal, you should connect an external modem to the
  680.   modem port.  The computer gives priority to the modem port so that
  681.   other printer port activities don't interfere with modem
  682.   activities.  Also, all AppleTalk devices must be connected to the
  683.   printer port, which is the only AppleTalk-capable port.
  684.   
  685.   [3.4]  Make sure call waiting is disabled.
  686.   
  687.   To disable call waiting on a touch tone phone, insert the string
  688.   "*70," before the phone number, like this:
  689.   
  690.   ATDT *70,555-5555
  691.   
  692.   The comma is a Hayes command which makes the modem wait for two
  693.   seconds.  Someone has suggested using w instead of a comma.  The w
  694.   tells the modem to wait for a dial tone.  On a pulse dial phone,
  695.   use "1170," instead of "*70,".  One reader reports that *67 enables
  696.   privacy (disables caller ID at the remote phone) for some telephone
  697.   companies.
  698.   
  699.   [3.5]  Make sure you have a hardware handshaking cable.
  700.   
  701.   If you have hardware handshaking turned on in the Connection
  702.   dialog, consult your modem manual to make sure you have a hardware
  703.   handshaking cable.  You can get away without one for awhile, but
  704.   they are ultimately necessary for high speed modems.
  705.   
  706.   A diagram of a correctly-wired hardware handshaking cable is hidden
  707.   in the Apple Modem Tool 1.1.  Open a copy in ResEdit and examine
  708.   PICT resource #20000.  In the Apple Modem Tool 1.5, the PICT
  709.   resources are #20808 for DIN-8 to DIN-8 wiring, and #20825 fro
  710.   DIN-8 to DB-25 wiring.  The new Apple Modem Tool 1.5 has a button
  711.   labelled Cabling, but it was grayed out on my machine.  I suspect
  712.   the button would work with an Apple Express Modem.  Any information
  713.   on the cabling button would be appreciated.
  714.   
  715.   To find out more about hardware handshaking, read issues #179 and
  716.   #180 of TidBITS, Adam Engst's free electronic magazine, available
  717.   from FTP sites and online services.
  718.   
  719.   [3.6]  Install Apple's Hardware System Update 2.0.1.
  720.   
  721.   The hardware update (AKA Hardware Enabler) corrects some problems
  722.   with high speed communications under System 7.1 on the following
  723.   machines: LC, LC II, IIsi, IIvx, IIvi, Classic II, Quadra 900, and
  724.   Quadra 950.  The updater solves other problems on these and other
  725.   machines, so users of System 7.1 should probably have it anyway. 
  726.   The updater should NOT be used on Performas. 
  727.   
  728.   I mention the hardware update out of a sense of duty to inform you
  729.   that it exists.  No one has actually reported that it solved any of
  730.   their telecommunications problems.  On the contrary, reports are
  731.   filtering in that the update causes some problems of its own.  Use
  732.   your own judgement.
  733.   
  734.   Day-to-day fixes:
  735.   
  736.   [3.7]  Quit other programs which use the modem.
  737.   
  738.   Communications programs that access the modem are sometimes
  739.   reluctant to give up control of the port the modem is attached to. 
  740.   Quit all other telecommunications software, as well as any phone
  741.   book programs that can dial phone numbers through the modem.
  742.   
  743.   [3.8]  Turn the modem off, wait a few seconds, then turn it
  744.          back on.
  745.   
  746.   This technique solves numerous connection and downloading problems.
  747.   Among other things, it closes the communications port, which may
  748.   have been left open by another application.
  749.   
  750.   [3.9]  Quit ZTerm, then relaunch ZTerm.
  751.   
  752.   Among other things, this forces ZTerm to resend the modem
  753.   initialization string.
  754.   
  755.   [3.10] Restart the computer.
  756.   
  757.   Restarting is a standard way of solving transient problems of any
  758.   kind.
  759.   
  760.   [3.11] Restart the computer with extensions off.
  761.   
  762.   Extensions (inits and cdevs under System 6) cause more than their
  763.   share of problems, and should always be suspect if the machine is
  764.   crashing or freezing.  Under System 7, restart with the shift key
  765.   held down to prevent extensions from loading.  Under System 6,
  766.   manually remove all inits and cdevs from the System Folder and
  767.   restart.
  768.   
  769.   See also 3.12.
  770.   
  771.   A few final possibilities:
  772.   
  773.   [3.12] Disable fax software and fax auto-answer.
  774.   
  775.   Fax software may prevent ZTerm from accessing the serial port to
  776.   which the modem is attached.  Remove fax extensions, control panels
  777.   and Chooser devices from the System folder.  Fax Chooser devices
  778.   are especially insidious.  Chooser devices aren't disabled when you
  779.   restart with extensions off under System 7.  If they were, print
  780.   drivers would be disabled, and you wouldn't be able to print.
  781.   
  782.   Consult your fax modem manual to learn how to disable fax
  783.   auto-answer.
  784.   
  785.   [3.13] Move the ZPhoneList out of the ZTerm folder.
  786.          (But don't throw it away!)
  787.   
  788.   Besides storing phone numbers, the ZPhoneList contains all of
  789.   ZTerm's settings and preferences, which may have been misset or
  790.   corrupted.  If you remove the file from the ZTerm folder, ZTerm
  791.   will create a new one using its default settings.  You can also
  792.   restore the file from a backup disk.  If that doesn't solve the
  793.   problem, put your old ZPhoneList back in the ZTerm folder so you
  794.   won't lose your phone numbers.
  795.   
  796.   
  797.   [4]    Known Bugs, ResEdit Fixes, and ResEdit Hacks
  798.   
  799.   [4.1]  Queue dialing
  800.   
  801.   When queue dialing, the dial window remains open after a connection
  802.   is made.
  803.   
  804.   [4.2]  File appends
  805.   
  806.   Appended text is inserted at the beginning of the file, rather than
  807.   at the end.
  808.   
  809.   [4.3]  Missing download folder
  810.   
  811.   If you attempt to download without selecting a default download
  812.   folder, ZTerm reports a -120 error instead of prompting you to
  813.   select a download folder.
  814.   
  815.   [4.4]  UNIX and Opus settings
  816.   
  817.   The radio buttons may change when you open the ZModem Options
  818.   dialog, but the settings remain unchanged, so the bug is not
  819.   serious.
  820.   
  821.   [4.5]  Sending returns in scripts
  822.   
  823.   When ZTerm sends a return by itself in a script, it usually sends a
  824.   space, then the return.  To fix the problem, open a copy of ZTerm
  825.   in ResEdit. Open the CODE resource, then open CODE ID=2. At offset
  826.   52B4 find the string 671E 4A6E FFEE.  Change 671E to 601E.
  827.   
  828.   [4.6]  Text pacing
  829.   
  830.   If text pacing is set to wait for a line prompt, ZTerm will usually
  831.   wait for about 5 seconds even if it receives the prompt character. 
  832.   To fix this bug, open a copy of ZTerm in ResEdit, open the CODE
  833.   resource, then open CODE ID=2.  At offset 5082, find the string
  834.   3B40 CAC0.  Change CAC0 to CABE.
  835.   
  836.   [4.7]  Unmarking all services
  837.   
  838.   Holding down shift-option and selecting Dial Marked is supposed to
  839.   unmark all services, but doesn't.
  840.   
  841.   [4.8]  Dialing with the scroll buffer scrolled back
  842.   
  843.   When dialing with the scroll buffer scrolled back, ZTerm crashes
  844.   when a connection is made.  This bug does not occur on all systems,
  845.   but occurs reproducibly on some.
  846.   
  847.   [4.9]  Non-bugs
  848.   
  849.   When the Dial directory is open, command-q invokes queue dialing,
  850.   rather than quitting ZTerm.  According to the ZTerm docs, this is
  851.   exactly what's supposed to happen.  Several other command key
  852.   shortcuts have different meanings when the Dial directory is open.
  853.   
  854.   When ANSI graphics leave the main window and enter the scroll
  855.   buffer, they lose their special formatting and color and become
  856.   text.  This is described in the ZTerm docs.
  857.   
  858.   [4.10]  Increasing the port buffer size with ResEdit
  859.   
  860.   Open a copy of the ZPhoneList in ResEdit.  Doubleclick the zSet
  861.   resource.  The first two bytes are the port buffer size.  X'1000 =
  862.   4K.  X'2000 = 8K.  X'3000 = 12K, etc.  Settings higher than X'7
  863.   (28K) are reported to be unreliable.  
  864.   
  865.   See also 5.9 to learn how to change the terminal font with ResEdit.
  866.   
  867.   
  868.   [5]    Dialing
  869.   
  870.   [5.1]  Why is one service in the Dial menu and in the Dial
  871.          directory in outline?
  872.   
  873.   That's the default service.  When you launch ZTerm, that service
  874.   will be the current service.  To set the default service, open the
  875.   Dial directory, hold down the command key, and click on the service
  876.   you want to be the default.  You can also hold down the command key
  877.   and select the service from the Dial menu.
  878.   
  879.   [5.2]  I started ZTerm and the only service listed is called
  880.          Local.  Wa' hoppen?
  881.   
  882.   ZTerm didn't find your ZPhoneList in the ZTerm folder, so it
  883.   created a new one with the default entry Local.  Find your
  884.   ZPhoneList and place it in the root level of the ZTerm folder.
  885.   
  886.   [5.3]  My ZPhoneList with a kajillion phone numbers and settings
  887.          got trashed.  Am I screwed?
  888.   
  889.   You're screwed.  Always back up your ZPhoneList when you perform
  890.   your routine backup.  Or, to put it another way, whenever you think
  891.   "Man, I really oughta back up my files one of these days," instead
  892.   think "Man, I really oughta back up my files, including my
  893.   ZPhoneList, one of these days."
  894.   
  895.   Several reports on comp.sys.mac.comm indicate that the ZPhoneList
  896.   can be corrupted when restarting a crashed Mac.  Apparently this
  897.   only occurs if you crash after making changes to the ZPhoneList
  898.   settings without saving the changes.  You can prevent this problem
  899.   by choosing Save Setup from the Dial menu whenever you change
  900.   ZTerm's settings.
  901.   
  902.   If your ZPhoneList becomes corrupted, you might be able to extract
  903.   the service names and numbers using Denise McElroy's ZTerm Phone
  904.   Directory Listing, available from FTP sites and America Online.
  905.   
  906.   [5.4]  Why won't ZTerm send my modem initialization string?
  907.   
  908.   ZTerm won't initialize the modem if the default service doesn't
  909.   have any characters in the Phone Number field.  To fix the problem,
  910.   type some characters in the field.  The characters don't have to be
  911.   a phone number.  "I am the Lizard King" works just fine.  So does a
  912.   couple of spaces.
  913.   
  914.   [5.5]  Using multiple ZPhoneLists.
  915.   
  916.   When you launch ZTerm, it looks for a file called ZPhoneList in the
  917.   ZTerm folder.  To force ZTerm to use a different ZPhoneList, quit
  918.   ZTerm and doubleclick on the other ZPhoneList, which does not have
  919.   to be in the ZTerm folder.  If multiple ZPhoneLists are present in
  920.   the ZTerm folder, they must have different names.
  921.   
  922.   To force ZTerm to create a new ZPhoneList, rename the old one, or
  923.   move it out of the ZTerm folder, and launch ZTerm.
  924.   
  925.   [5.6]  Undocumented tip: changing the data rate.
  926.   
  927.   You can change the data rate without going to the connection
  928.   dialog. Click on the data rate string at the bottom of the window
  929.   to get a popup menu for changing the data rate.
  930.   
  931.   [5.7]  Undocumented tip: changing parity, data bits, and stop bits.
  932.   
  933.   Likewise, clicking on the string to the right of the data rate
  934.   string produces a popup menu for selecting N-8-1, E-7-1, or O-7-1
  935.   settings.
  936.   
  937.   [5.8] Undocumented tip: dialing the current service.
  938.   
  939.   Command-shift-d normally dials marked services.  If no services are
  940.   marked, command-shift-d dials the current service.
  941.   
  942.   [5.9]  Undocumented tip: adding a separator line to the Dial menu.
  943.   
  944.   Create a new service.  In the Service Name field, type one or more
  945.   "-" (hyphens).  The Dial menu will now have a standard gray
  946.   separator line.  To take advantage of the separator, some of your
  947.   service names must come alphabetically before the hyphen.  The
  948.   easiest way to do this is to prefix some of the service names with
  949.   spaces, which forces them to the top of the Dial menu.
  950.   
  951.   P.S. I have lost the name of the person who posted this tip to
  952.   comp.sys.mac.comm.  If that person would be so kind as to send me
  953.   their name, I'll add it to the credits.
  954.   
  955.   
  956.   [6]    Connecting
  957.   
  958.   [6.1]  When ZTerm dials, the dialing line has the A cut off the
  959.          dial string, like this: TDT 691-7094.  Tell me, tell me!
  960.          Whatever could be wrong?
  961.   
  962.   First, make sure your modem is turned on, that the modem cable is
  963.   properly connected to the computer and to the phone jack, and that
  964.   ZTerm is sending data to the correct port.
  965.   
  966.   Assuming all is well with the modem connection, the consensus seems
  967.   to be that this behavior occurs because a previous comm program
  968.   left the communications port open.  If you witness this behavior,
  969.   quit ZTerm, turn the modem off and then back on, and relaunch
  970.   ZTerm.  One person reported that changing the data rate from 57600
  971.   to 38400 solved his problem.  Another fixed the problem on his
  972.   PowerBook by adding a comma to the beginning of the predial
  973.   initialization string.
  974.   
  975.   Thanks to everyone on comp.sys.mac.comm and comp.dcom.modems for
  976.   their valuable feedback on this problem!
  977.   
  978.   [6.2]  Why is ZTerm so slow at sending passwords on some
  979.          services?
  980.   
  981.   You have "Wait for character echo" turned on in the Text Pacing
  982.   options, but the remote system isn't echoing the password
  983.   characters, so ZTerm waits 5 seconds, times out, and sends the next
  984.   character.  Turn off the "Wait for character echo" option for that
  985.   service.
  986.   
  987.   [6.3]  Why isn't there a setting for 14400 bps?
  988.   
  989.   The setting in the connection dialog controls the DTE speed (AKA
  990.   terminal speed, Mac-to-modem speed, serial port speed, or what
  991.   ZTerm calls the data rate), not the DCE speed (AKA connection
  992.   speed, modem-to-modem speed, or carrier speed).  14400 is a DCE
  993.   speed, not a DTE speed.
  994.   
  995.   [6.4]  What data rate should I use with a 14400 bps modem?
  996.   
  997.   With a high speed modem, you want to set the serial port speed
  998.   higher than the carrier speed so that the modem won't get ahead of
  999.   the computer.  Also, most v.32bis (14400 bps) modems feature
  1000.   hardware compression methods such as v.42bis and MNP 5.  To take
  1001.   advantage of hardware compression, the serial port speed must be
  1002.   higher than the carrier speed.
  1003.   
  1004.   When using a 14400 bps modem to connect to another 14400 bps modem,
  1005.   set the DTE speed in the Connection dialog to 19200.  You can
  1006.   experiment with higher values, but 19200 should work reliably. 
  1007.   Some users report that high DTE speeds are unreliable when
  1008.   AppleTalk is enabled in the Chooser DA.  Many people experience
  1009.   problems with 57600 DTE speeds.
  1010.   
  1011.   [6.5]  Why can't I connect at 14400 bps?
  1012.   
  1013.   Send the modem an AT&V command, which will display all settings. If
  1014.   you see \J1, you've found the problem.  \J1 enables port rate
  1015.   adjust.  (This setting may be something other than \J on some
  1016.   modems. Check your manual.)  This means that the DTE speed will
  1017.   adjust to the DCE speed.  But if you connect at 14400 bps, you're
  1018.   in trouble, since ZTerm can't send data to the serial port at 14400
  1019.   bps.  To fix the problem, send AT\J0 (zero) to the modem.  Better
  1020.   yet, add \J0 to the modem initialization string in the Modem
  1021.   Preferences dialog.
  1022.   
  1023.   [6.6]  How can I prevent my modem from constantly dropping carrier?
  1024.   
  1025.   Tell the modem to ignore DTR.  The appropriate string for most
  1026.   modems is &D0.  You cannot use hardware handshaking if &D0 is set. 
  1027.   Be sure to read the section 6.7 to avoid problems hanging up the
  1028.   phone line.
  1029.   
  1030.   See also 3.4 if you have call waiting.
  1031.   See also 3.12 if you have a fax modem.
  1032.   
  1033.   [6.7]  Why won't my modem hangup?
  1034.   
  1035.   The modem's &D setting and ZTerm's setting for hardware (DTR)
  1036.   hangup are conflicting.  The setting is in ZTerm's Modem
  1037.   Preferences dialog.  Send the command AT&V to your modem to find
  1038.   your &D setting, and set the hardware hangup according to the
  1039.   following table:
  1040.   
  1041.    If your modem is              Use this setting in ZTerm's
  1042.      set to this:                     Modem Preferences:
  1043.   
  1044.        &D0                    Set Hardware Hangup (DTR) to off
  1045.        &D1                    Set Hardware Hangup (DTR) to off.
  1046.        &D2                    Set Hardware Hangup (DTR) to on.
  1047.        &D3                    Set Hardware Hangup (DTR) to on.
  1048.   
  1049.   Note that I'm assuming you've set &D to the correct setting.  If
  1050.   not, all bets are off.  Check the "Hardware Hangup (DTR)" box to
  1051.   turn hardware hangup on.  Uncheck the box to turn it off.  If all
  1052.   else fails, turn DTR hangup off.  DTR hangup is faster, but
  1053.   software hangup works almost every time.
  1054.   
  1055.   
  1056.   [7]    File Transfers
  1057.   
  1058.   [7.1]  This text, binary, MacBinary, and Smart MacBinary stuff
  1059.          makes my head spin.  Which should I use?
  1060.   
  1061.   Unless you know better, use Smart MacBinary, which will
  1062.   automatically select the correct transfer mode.  The major
  1063.   exception is if you are uploading non-text files, such as GIFs or
  1064.   .zip files, which PC users will use.  In that case, use binary to
  1065.   prevent Finder information from being sent.
  1066.   
  1067.   This reason this setting is so important is because of the Mac's
  1068.   unique file format.  Macintosh files have two forks, or parts --
  1069.   the data fork and the resource fork.  The data fork holds data,
  1070.   i.e. text.  The resource fork holds resources such as compiled
  1071.   code, pictures, sounds, etc.  Text files are usually all data. 
  1072.   Applications are mostly resources.  This two part structure is
  1073.   unique to the Mac.  If you send Mac files to other types of
  1074.   computers, the files will be damaged.  Using MacBinary transfers
  1075.   prevents this damage.
  1076.   
  1077.   [7.2]  When I download Mac files from a PC BBS, the files have
  1078.          generic icons and are unusable. What went wrong?
  1079.   
  1080.   You didn't use MacBinary or Smart MacBinary. See 7.1.
  1081.   
  1082.   [7.3]  Which transfer protocol should I use?
  1083.   
  1084.   If the service you're calling supports ZModem, use it, because:
  1085.   
  1086.   1. ZModem is very fast.
  1087.   
  1088.   2. ZModem is a batch protocol, meaning you can place more than one
  1089.   file into a batch for uploading or downloading.  Most protocols
  1090.   make you request files one at a time.
  1091.   
  1092.   3. ZModem has crash recovery.  If a 3 hour download is interrupted
  1093.   1 minute before it finishes, you can redial the service, start the
  1094.   download again, and finish where you left off.
  1095.   
  1096.   4. ZModem receives begin automatically.  To start a ZModem
  1097.   download, simply tell the other computer to begin the transfer. 
  1098.   Your computer will detect a ZModem transfer and automatically enter
  1099.   receive mode.  This autoreceive feature necessitates the default
  1100.   download folder, which ZTerm also uses with other transfer
  1101.   protocols.
  1102.   
  1103.   5. ZModem handles XON/XOFF software flow control better than other
  1104.   protocols.
  1105.   
  1106.   6. ZModem detects the presence of hardware error correction, such
  1107.   as MNP 4 and v.42, and turns off its own error detection.  The
  1108.   result is faster throughput when using error-correcting modems.
  1109.   
  1110.   [7.4]  Does ZTerm support batch ZModem downloads?
  1111.   
  1112.   Yes.  ZModem is by definition a batch protocol.  To download
  1113.   multiple files from UNIX using ZModem, use the command
  1114.   
  1115.     sz -w 2048 file1.txt file2.hqx etc.
  1116.   
  1117.   [7.5]  Interrupting ZModem downloads is messy.  What's a modem
  1118.          freak to do?
  1119.   
  1120.   Send an ASCII abort or interrupt character.  The abort character
  1121.   varies from host to host, but should be either control-x or
  1122.   control-k.  Control-c is the ASCII interrupt character.  Whichever
  1123.   character you send, type it repeatedly.
  1124.   
  1125.   [7.6]  Can I use ZModem from my VAX or UNIX account?
  1126.   
  1127.   Yes.  The necessary source code for VAX is available via anonymous
  1128.   FTP from ee.utah.edu in the directory /Comm/Rzsz.  You will need
  1129.   everything but the .tar file.  The source code is too large to fit
  1130.   into my account, so I am currently trying to obtain the executable
  1131.   binary.
  1132.   
  1133.   The source code for UNIX is available via anonymous FTP from
  1134.   sumex-aim.stanford.edu in the directory info-mac.comm.  The four
  1135.   files are in UNIX shar format.  I am told that they are not in ANSI
  1136.   C format.  My informant says that UNIX users can use the K & R
  1137.   compiler and use the command -cckr.  
  1138.   
  1139.   [7.7]  How do I prevent massive CRC errors during ZModem
  1140.          downloads from UNIX?
  1141.   
  1142.   Try the following suggestions from Fernmail author Dave Platt:
  1143.   
  1144.   "The commonest reason for this sort of failure-to-resynchronize is,
  1145.   in my experience, excessive data buffering between the sending "sz"
  1146.   process and the receiving program.  The ZMODEM protocol can become
  1147.   badly confused if you're connected to your host via a TCP-based
  1148.   terminal server or some similar serial data switch.  If the
  1149.   terminal server and the network software provides a substantial
  1150.   amount of data buffering (as it probably does), then the two ZMODEM
  1151.   processes will each see a _long_ delay between the time that they
  1152.   send a message to their peer, and the time that the response to
  1153.   this message makes it through the network to them.  This delay will
  1154.   interfere with the protocol's error-recovery timeouts, and can lead
  1155.   to an endless stream of recovery attempts.
  1156.   
  1157.   "I strongly suggest using the poorly-documented "-w" option when
  1158.   downloading files from a mainframe or workstation, unless you're
  1159.   _sure_ that all of the data communication links between you and the
  1160.   host are running at the same speed and don't do data buffering. 
  1161.   The "-w" option enables a four-packet sliding-window mode, which
  1162.   will guarantee that sz will never "get ahead" of your Mac by more
  1163.   than the window-size that you specify.  As long as the window size
  1164.   is no more than (e.g.) 10 seconds worth of data, there won't be a
  1165.   problem with the retry timers expiring before the window is
  1166.   emptied.
  1167.   
  1168.   "I usually use "sz -w 2048 filename" when downloading.  In fact, I
  1169.   have "sz" aliased to "sz -w 2048" to ensure that I don't forget to
  1170.   use windowed mode."
  1171.   
  1172.   [7.8]  I have other transfer problems with UNIX.  What's Dave
  1173.          been smokin'?
  1174.   
  1175.   If you have trouble with UNIX when you use the telnet command, try
  1176.   the rlogin command, and vice versa.  This tip has solved many
  1177.   problems for UNIX users.
  1178.   
  1179.   [7.9] I have an error-correcting modem.  Which protocol should I
  1180.         use?
  1181.   
  1182.   You should probably still use ZModem, but you might also consider
  1183.   YModem-G.  Other protocols have software error correction which is
  1184.   redundant and time consuming if your modem has hardware error
  1185.   checking.  (Note that ZModem has error detection, but turns off its
  1186.   own error correction if it senses a reliable connection between two
  1187.   error-correcting modems.)  Be sure that hardware error correction
  1188.   is enabled on both modems.  Consult your modem manual for
  1189.   instructions.  The downside to YModem-G is that there is no error
  1190.   recovery, so the transfer terminates if an error is detected.  For
  1191.   this reason, you shouldn't use YModem-G if you have noisy phone
  1192.   lines or are transferring large files.
  1193.   
  1194.   [7.10] Why can't I do ZModem uploads to Delphi?
  1195.   
  1196.   One person reports that changing the ZModem options from rz to uz
  1197.   fixed his uploading problems.
  1198.   
  1199.   [7.11] Where's YModem-G Send?
  1200.   
  1201.   According to ZTerm's excellent Balloon Help, YModem1K send is the
  1202.   same as YModem-G send.
  1203.   
  1204.   [7.12] Why does YModem work on some systems and not others?
  1205.   
  1206.   What some BBSs call YModem is actually XModem-1K.  If the BBS
  1207.   offers YModem and YModem Batch, use YModem Batch, which is the true
  1208.   YModem ZTerm expects.  Otherwise, if YModem transfers aren't
  1209.   working, tell the BBS to send YModem, and tell ZTerm to receive
  1210.   XModem-1K.  Frankly, this is just one more reason to use ZModem.
  1211.   
  1212.   [7.13] Using hardware compression makes my uploads and downloads
  1213.          slower.  Was ist los?
  1214.   
  1215.   Most online files are compressed with software utilities such as
  1216.   Stuffit and Compact Pro and can't be compressed much more, if at
  1217.   all.  Therefore, the time the modem spends trying to compress and
  1218.   decompress the files can actually slow down the transfers.  V.42bis
  1219.   is supposed to detect compressed files and turn off its own
  1220.   compression, but it doesn't always work  If hardware compression
  1221.   causes problems, consult your modem manual to learn how to turn it
  1222.   off.
  1223.   
  1224.   [7.14] If I have the Kermit/VT102/etc. Tool, will ZTerm support
  1225.          Kermit/VT102/etc.?  Are any ZModem tools available?
  1226.   
  1227.   No.  ZTerm doesn't use the Communications Toolbox for terminal
  1228.   emulation, connection, or file transfer, so it can't use
  1229.   Communications Toolbox tools.  The freeware Termy, by Tim Endres of
  1230.   Ice Engineering, can.  I've used Termy and Kermit Tool GH with
  1231.   great success.  Kermit Tool GH also works very well with
  1232.   Communicate Lite.
  1233.   
  1234.   There are no freeware or shareware ZModem tools available at this
  1235.   time.  Payware ZModem tool currently available include Pacer
  1236.   Software's PacerTerm (see MacWEEK (08.09.93) and Seaquest's tools
  1237.   pack.  When released, Aladdin System's SITcomm will includ a ZModem
  1238.   tool.  The next version of Communications Lite from Mark/Space
  1239.   Softworks will also include a ZModem tool, and will be a free
  1240.   upgrade for registered users.  A demo version of Communicate Lite
  1241.   is available from America Online and via anonymous FTP from
  1242.   netcom.com in the directory mspace/pub.
  1243.   
  1244.   By the time you read this, Crosstalk for Macintosh 2.0 by Digital
  1245.   Communications Associates, Inc. should be available.  According to
  1246.   MacWEEK (10.11.93), Crosstalk will support XModem, YModem, ZModem,
  1247.   Kermit, CompuServe QuickB, IND$FILE, and FTTERM. Terminal emulation
  1248.   includes PC ANSI, VT320, ADDS Viewpoint+, HP 700/94, Wyse 50 and
  1249.   Televideo 950.  Owners of the PC version or of competing Mac
  1250.   programs can upgrade for $49.  Contact Digital Communications
  1251.   Associates at (404-442-4000).
  1252.   
  1253.   Look for reviews of SITcomm and Communicate Lite in an upcoming
  1254.   FAQ.
  1255.   
  1256.   [7.15] How can I resume downloads interrupted by a meddling
  1257.          cat?
  1258.   
  1259.   If an animal, two legged or four legged, presses the 9 key during a
  1260.   download, ZTerm will display
  1261.   
  1262.      zrdata: cnt = 1024
  1263.      zrdat32: cnt = 1024
  1264.   
  1265.   et cetera ad nauseam.  To fix the problem, press the 0 (zero) key. 
  1266.   My friend Neil Schulman discovered this.  Dave Alverson tells him
  1267.   this behavior is actually a debugger built into ZTerm.  More
  1268.   details as they become available, modem fans.
  1269.   
  1270.   [7.16] Hellfire tarnation and a monkey! Why's my transfer
  1271.          efficiency so low?
  1272.   
  1273.   It may not be low at all.  Ignore the percent efficiency figure. 
  1274.   The characters per second (cps) rate is a better indicator of
  1275.   efficiency.  On the Mac, one character is eight bits.  Sending that
  1276.   characer over a phone line requires the addition of a start bit and
  1277.   a stop bit.  To convert cps to bits per second (bps), multiply cps
  1278.   by ten.  The maximum theoretical efficiency without hardware
  1279.   compression or error correction would be 240 cps for 2400 bps
  1280.   modems, 960 for 9600, and 1440 for 14400.  The efficiency won't be
  1281.   that high, because of line noise and the overhead inherent in any
  1282.   file transfer protocol.  Hardware error correction such as MNP 4
  1283.   and V.42 can increase throughput by as much as eight percent. 
  1284.   Hardware compression such as MNP 5 and V.42bis can increase
  1285.   throughput dramatically, assuming the files aren't already
  1286.   compressed with Stuffit, Compact Pro, etc.
  1287.   
  1288.   The reason you should ignore the percent efficiency is that ZTerm
  1289.   normally calculates percent transfer efficiency by dividing the
  1290.   actual throughput by the DTE speed (what ZTerm calls the data
  1291.   rate).  Assuming your modem is transferring data at exactly 14400,
  1292.   ZTerm will report the efficiency to be 14400/19200 = 75% at 19200,
  1293.   14400/38400 = 38% at 38400, and 14400/57600 = 25% at 57600.  Yet in
  1294.   each case the actual transfer efficiency is the same.
  1295.   
  1296.   Having said all of that, you can use the percent effiency figure if
  1297.   your modem supports the ATW2 command.  When the modem is set to W2,
  1298.   ZTerm reports the connect speed as the DCE speed rather than the
  1299.   DTE speed, and calculates percent efficiency based on the DCE
  1300.   speed.  So if your modem is transferring data at exactly 14400,
  1301.   ZTerm will report the efficiency to be 14400/14400 = 100%.
  1302.   
  1303.   
  1304.   [8]    Sound, ANSI Graphics, and Color
  1305.   
  1306.   [8.1]  Why oh why won't the ZTerm sounds play?
  1307.   
  1308.   The sounds must be stored in the System file (AKA System suitcase).
  1309.    See 8.2.
  1310.   
  1311.   [8.2]  Can I use sounds other than the ones that come with ZTerm?
  1312.   
  1313.   Absolutely.  You can rename any system-compatible sound to
  1314.   "Connect", "Filedone" or "Termbell" and install the sound in the
  1315.   System file.  Under System 7, quit all applications and desk
  1316.   accessories and drag the sounds to the icon of the closed System
  1317.   Folder.  When asked if you want the sounds installed in the system
  1318.   file, click OK.
  1319.   
  1320.   System 6 users can install sounds into the System file using the
  1321.   shareware SoundMover (shareware by Riccardo Etore) or Apple's
  1322.   ResEdit.  You can also use a resource manager, such as Fifth
  1323.   Generation System's SuitCase or Alsoft's MasterJuggler, to open the
  1324.   sounds with ZTerm.
  1325.   
  1326.   [8.3]  Is there any limit on the length of the sounds?
  1327.   
  1328.   ZTerm doesn't limit the length of the sounds, but ZTerm can't send
  1329.   or receive data while the sounds are playing.  Therefore, a long
  1330.   connect sound may cause connection problems.
  1331.   
  1332.   [8.4]  How do I turn my modem speaker down or off?
  1333.   
  1334.   This one is near and dear to my heart, as I used to have the 2400
  1335.   bps Modem for the Deaf(TM).  ZTerm offers three ways to turn the
  1336.   modem speaker off (AT M0), or to turn the speaker down (AT L0) if
  1337.   it's on.  (All 0's are zeroes, as they always are in the Hayes
  1338.   language.  The only exception is The ATOn command, which is used to
  1339.   return the modem to online mode.  In that case, "O" is an "oh". The
  1340.   n is a placeholder for an integer number.)  M1 turns the speaker
  1341.   back on.  L1 turns the volume back up.
  1342.   
  1343.   1. You can manually do the deed by typing AT M0 or AT L0 before you
  1344.   make a connection.  This method is best if you only want to silence
  1345.   the modem for some sessions.
  1346.   
  1347.   2. To automatically change the volume when dialing a particualr
  1348.   service, enter AT M0 or AT L0 in the "Pre-dial init" field in that
  1349.   service's Connection dialog.  This method is best if you want the
  1350.   speaker on for some services and off for others.
  1351.   
  1352.   3. To automatically control the volume for all services, select
  1353.   Modem Preferences.  Click in the "Initialize" field and use the
  1354.   cursor keys to move to the far right.  Move the cursor just to the
  1355.   left of ^M  and type M0 or L0.  This method is best if you want the
  1356.   speaker off for every service, every time.
  1357.   
  1358.   These three techniques work for any initialization string,
  1359.   incidentally.
  1360.   
  1361.   [8.5]  Why can't women see what a great guy I am?
  1362.   
  1363.   Man!  I've been trying to figure out the same thing for years. You
  1364.   tell me.
  1365.   
  1366.   [8.6]  How do I get ANSI graphics when connecting to a PC BBS?
  1367.   
  1368.   1. Select Terminal Settings for that service and choose the PC ANSI
  1369.   BBS radio button.
  1370.   
  1371.   2. Also in the Terminal Settings dialog, uncheck the "No Extended
  1372.   Characters (Strip hi bit)" box if it's checked.
  1373.   
  1374.   3. In the Color Preferences dialog, check the Use Color box.
  1375.   
  1376.   4. In the Terminal Preferences dialog, set the font size to 9 or 12
  1377.   point.  Other sizes will not work with ANSI graphics.  See 10.2.
  1378.   
  1379.   5. In the Monitors control panel, set the monitor depth to 256
  1380.   colors or higher.  16 colors will do in a pinch.  If your Mac is
  1381.   limited to 16 colors, I recommend using Jon Snell's ZTerm High
  1382.   Speed Patch, which installs a 16 color palette into ZTerm.
  1383.   
  1384.   [8.7]  I did all of that and the ANSI graphics still look a
  1385.          little funny.  What gives?
  1386.   
  1387.   ZTerm 0.9 uses 8 colors for ANSI emulation, while some ANSI
  1388.   graphics use 16 colors.  The next version will support 16 color
  1389.   ANSI emulation.
  1390.   
  1391.   [8.8]  How can I add excitement to my dull and monotonous life?
  1392.   
  1393.   Select Color Preferences and choose colored text on a darker
  1394.   background.  I use yellow text on a black background.  Use whatever
  1395.   colors you want.  It's your life.
  1396.   
  1397.   
  1398.   [9]    VT100 Emulation
  1399.   
  1400.   [9.1]  I'm wiggin' out, Leslie.  Why don't the home, end, page
  1401.          up, and page down keys on my extended keyboard work?
  1402.   
  1403.   During VT100 emulation, those keys are assigned to VT100
  1404.   operations.  To make them work like normal Macintosh application
  1405.   keys, hold down the shift key and then press them.
  1406.   
  1407.   [9.2]  Why don't the f1-f4 editing keys on my extended keyboard
  1408.          work?
  1409.   
  1410.   During VT100 emulation, all of the function keys are assigned to
  1411.   VT100 operations.  Use the command key shortcuts or the edit menu.
  1412.   
  1413.   [9.3]  How can I emulate a control key on a Mac Plus?
  1414.   
  1415.   If you are using System 7 on a U.S. system, install the ZTerm
  1416.   Keyboard layout.  To do this, drag the keyboard layout to the icon
  1417.   of the closed system folder.  When asked if you want to install the
  1418.   keyboard layout, click OK.  The option key will now emulate the
  1419.   control key.
  1420.   
  1421.   If you are using a non-U.S. system, or a system earlier than 7.0,
  1422.   select Terminal Settings from the Settings menu.  Assign the
  1423.   control key function to the command key.
  1424.   
  1425.   [9.4]  How can I emulate an escape key on a Mac Plus?
  1426.   
  1427.   When Option for Control is checked in Terminal Preferences, the
  1428.   accent/grave key in the upper left hand corner of the keyboard
  1429.   emulates the escape key.
  1430.   
  1431.   [9.5]  How can I emulate a VT100 numeric keypad on a PowerBook?
  1432.   
  1433.   Use NumericKeypad (AKA U.S. Keypad), a ResEdit resource and keypad
  1434.   written by Mel Park, of the University of Tennessee, Memphis. 
  1435.   NumericKeypad maps the numeric keypad to the regular keyboard when
  1436.   the caps lock key is engaged.
  1437.   
  1438.   [9.6]  Undocumented tip: positioning the cursor with the mouse.
  1439.   
  1440.   Not only can you use the mouse to select text, you can also use it
  1441.   to position the cursor when in editing mode.  Hold down the option
  1442.   key.  The pointer will become diamond shaped and will move the
  1443.   cursor, somewhat slowly, to wherever you click.
  1444.   
  1445.   
  1446.   [10]   Text and Text Files
  1447.   
  1448.   [10.1] Can I make the terminal font bigger?
  1449.   
  1450.   Yes.  Select Terminal Preferences from the Settings menu and enter
  1451.   a larger size.
  1452.   
  1453.   [10.2] Why does onscreen text look so crummy in anything but 9 or
  1454.          12 point?
  1455.   
  1456.   ZTerm uses its own terminal font for 9 and 12 point, but uses
  1457.   Monaco for other sizes.  If you want to see ANSI graphics, it is
  1458.   essential that you select 9 or 12 point.  Monaco doesn't contain
  1459.   the special characters needed for ANSI emulation.
  1460.   
  1461.   A font-morphing wiz could help Dave Alverson and ZTerm users by
  1462.   creating, say, 10 and 11 point sizes of the ZTerm font.  Contact
  1463.   Dave Alverson if you're interested.
  1464.   
  1465.   [10.3] Will ZTerm save text files in something other than
  1466.          TeachText?
  1467.   
  1468.   Yes.  To change the application ZTerm saves text files in, choose
  1469.   General Preferences from the Settings menu and choose a new file
  1470.   creator.  TeachText can't open files larger than 32K, so this
  1471.   feature is especially useful if you save large text files.
  1472.   
  1473.   [10.4] How can I increase the size of the scroll buffer?
  1474.   
  1475.   ZTerm stores the contents of the scroll buffer in memory.  To
  1476.   increase the memory partition, increase the current size in ZTerm's
  1477.   Get Info window.  One user has reported that setting the memory
  1478.   size above 1000K disables scrolling, but I was unable to duplicate
  1479.   that problem.  If you experience trouble with large memory
  1480.   settings, reduce the setting below 1000K.
  1481.   
  1482.   [10.5] Why do some characters get corrupted when I copy text from
  1483.          my word processor and paste it into ZTerm?
  1484.   
  1485.   The characters you've pasted are illegal on the system you're
  1486.   logged in to.  A lengthy explanation follows.
  1487.   
  1488.   On the Macintosh, all eight bits of a byte are used for 
  1489.   characters, producing 256 possible characters (two to the eighth
  1490.   power is 256), though some of these are dead keys, command keys,
  1491.   etc.  Mainframes use only seven bits for text, producing only 128
  1492.   possible characters (two to the seventh power is 128).  This seven
  1493.   Interchange, pronounced "asskey").  If you use any characters which
  1494.   use the eighth bit, the mainframe ignores the last bit and uses the
  1495.   first seven bits to determine which character to display.
  1496.   
  1497.   To avoid illegal characters when composing text for a mainframe,
  1498.   never use any characters which require pressing the option key.
  1499.   Also, in your word processor, turn off smart (curly) quotes , which
  1500.   use the eighth bit.  When smart quotes are turned on, the word
  1501.   "don't" usually becomes "donUt" when pasted to a mainframe.  And
  1502.   I'll bet dollars to donUts you donUt want that to happen.
  1503.   
  1504.   If you need to upload or paste text files containing illegal eighth
  1505.   bit characters, process the file with the Zap Gremlins command in
  1506.   BBEdit Lite 2.3 (freeware by Richard Siegel).
  1507.   
  1508.   [10.6] Undocumented tip: changing the terminal font with ResEdit.
  1509.   
  1510.   Shigeru Yamamoto asked Dave how to use ZTerm with a Japanese font. 
  1511.   Dave's instructions follow: 
  1512.   
  1513.   "If you want to try a Japanese font, here's what to do: open the
  1514.   ZPhoneList file with ResEdit and open the zSet resource.  (Leave
  1515.   the one in the program file alone, it's only used as defaults when
  1516.   the ZPhoneList is created.)  At offset 80 hex in this resource is
  1517.   the font name used when emulation is set to VT100.  At 90 hex is
  1518.   the font for PC-ANSI.  They are pascal strings, so the first byte
  1519.   is the number of characters in the name.  They are fixed fields of
  1520.   16 bytes, so the longest name that will work is 15 bytes.  Make
  1521.   sure you don't change the size of the field, because everything
  1522.   after it is position dependent."
  1523.   
  1524.   
  1525.   [11]   Macros and Scripting
  1526.   
  1527.   See also 4.5 for an explanation of a scripting bug and an easy fix.
  1528.   
  1529.   [11.1] How do I know the script is running?
  1530.   
  1531.   You will see a letter or two in the lower right hand corner of the
  1532.   terminal window.  These letters are abbreviations for the command
  1533.   the script is preparing to execute.  By noting which commands have
  1534.   executed, you can debug scripts more easily.
  1535.   
  1536.   These are the abbreviations and their meanings, as provided by Dave
  1537.   Alverson:
  1538.   
  1539.   b : beep
  1540.   s : send
  1541.   w : wait
  1542.   wp: wait prompt
  1543.   wq: wait for quiet
  1544.   
  1545.   [11.2] How do I cancel a script?
  1546.   
  1547.   Hold down the command key and type a period.  Command-period, AKA
  1548.   the Universal Mac Distress Code, also cancels printing and pastes,
  1549.   in ZTerm or most other applications, and is the keyboard shortcut
  1550.   for the cancel button in most dialog boxes.
  1551.   
  1552.   [11.3] How do I send an escape/linefeed/etc. in a script?
  1553.   
  1554.   To send an escape, use the line:
  1555.   
  1556.     send "^["
  1557.   
  1558.   where "[" is the lowercase left hand bracket, and "^" is the
  1559.   shift-6 control character.  Substitute "^j" for linefeeds. 
  1560.   Basically, you can send any ASCII character using a script.  All
  1561.   you need is a table of ASCII characters and their meaning.
  1562.   
  1563.   [11.4] Do I have to use the Wait for "da da da" prompt syntax?
  1564.   
  1565.   No.
  1566.   
  1567.     Wait prompt "da da da"
  1568.   
  1569.   works just fine.
  1570.   
  1571.   [11.5] Why is ZTerm sending only part of a line?
  1572.   
  1573.   When a line begins with the "send" command, ZTerm sends everything
  1574.   between the first set of quotes and the second set of quotes.  If
  1575.   the string looks like this:
  1576.   
  1577.     send " "It is not I who am crazy ... It is I who am MAD!!!" ^M"
  1578.   
  1579.   ZTerm will send a space, since that's what is between the first and
  1580.   second set of quotes.
  1581.   
  1582.   [11.6] How can I send quotation marks within a send statement?
  1583.   
  1584.   I used to say it couldn't be done, but I found a way.
  1585.   
  1586.   ZTerm recognizes four varieties of quotation marks: single quote,
  1587.   double quote, smart single quote, and smart double quote.  If you
  1588.   begin a send statement with one type, ZTerm won't stop sending
  1589.   until it reaches another quote of the same type.  (It doesn't,
  1590.   however, care which way the smart quotes face.)  For instance, if
  1591.   the send line looks like this:
  1592.   
  1593.     send ' "It is not I who am crazy ... It is I who am MAD!!!" ^M'
  1594.   
  1595.   ZTerm will send everything within the single quote marks
  1596.   (apostrophes).
  1597.   
  1598.   If your send string contains double and single quotes, enclose the
  1599.   string within smart quotes.  KeyCaps DA will show you the correct
  1600.   keys for producing smart quotes in your word processor or text
  1601.   editor.  As a rule of thumb, don't enclose smart quotes within the
  1602.   send string.  See 10.5.
  1603.   
  1604.   [11.7] What does error -49 mean?
  1605.   
  1606.   It means that the script ZTerm tried to use is open in another
  1607.   application, such as your word processor.  Close the file and try
  1608.   again.
  1609.   
  1610.   [11.8] I'm goin' nuts! Why won't my login script run?
  1611.   
  1612.   There could be a number of reasons.
  1613.   
  1614.   1. The file may not be in the right place.  Login scripts must be
  1615.   stored in the root level of the ZTerm folder.  That is, you should
  1616.   be able to see the ZTerm application and the script in the same
  1617.   Finder window using an icon view.
  1618.   
  1619.   2. The file may not have the correct name.  Login scripts should
  1620.   have the same name as the service, with the ".zts" extension on the
  1621.   end.  If the service is called " MacClique" (note the space), the
  1622.   script should be called " MacClique.zts", with a space.
  1623.   
  1624.   3. The script may not be in text only format.  ZTerm can only read
  1625.   text only files (files of type code text), such as TeachText files.
  1626.   If you write the script with your word processor, be sure to use
  1627.   the Save As command and select a text only format.  If TeachText
  1628.   can't open the file, it is not in text only format.  One exception:
  1629.   TeachText can't open any file larger than 32K.  Or had I mentioned
  1630.   that already?  If you have a working, useful script larger than
  1631.   32K, I'd like to shake your hand.
  1632.   
  1633.   4. The script may be an alias.  ZTerm doesn't recognize aliased
  1634.   scripts.
  1635.   
  1636.   5. There may be something wrong with your login script.  To test
  1637.   your script, connect to the service, select the Run Script command,
  1638.   and tell ZTerm to use the login script.  If the script doesn't work
  1639.   when run manually, the script is faulty.  Check spelling and
  1640.   syntax.  
  1641.   
  1642.   [11.9]Login script example
  1643.   
  1644.   The login script for my university's timesharing network follows:
  1645.   
  1646.   wait prompt "ENTER HOST NAME OR HELP >"
  1647.   send "vax^M"
  1648.   wait prompt "Username:"
  1649.   send $account "^M"
  1650.   wait prompt "Password:"
  1651.   send $password "^M"
  1652.   
  1653.   Note that $account and $password are NOT inside quotation marks. 
  1654.   For this script to work, the values for $account and $password must
  1655.   be entered into the Connection dialog.
  1656.   
  1657.   [11.10]Undocumented tip: sending a sig with a script and macro.
  1658.   
  1659.   UNIX users often include a signature at the end of their messages. 
  1660.   The signature, or sig, often includes the person's name, email
  1661.   address, affiliation, etc.  Sigs are automated in UNIX.  ZTerm
  1662.   users can easily include a sig with their email by creating a sig
  1663.   script.
  1664.   
  1665.   Launch your favorite text editor or word processor, set the font to
  1666.   Monaco, and write the sig as you want it to appear.  Then enclose
  1667.   each line of text in quotation marks, type "send" without the
  1668.   quotes in front of each line, and include a ^M before the second
  1669.   set of quotation marks.  To send a blank line, send a ^M by itself.
  1670.   Save the script in the ZTerm folder and name it sig.  If you use a
  1671.   word processor, be sure to use Save As and save in a text only
  1672.   format.
  1673.   
  1674.   Example:
  1675.   
  1676.   send
  1677.   "************************************************************^M"
  1678.   send "Leslie Jones       ljones@utkvx.utk.edu      AOL:
  1679.   LeslieJonz^M"
  1680.   send "^M"
  1681.   send "Made from only the freshest electrons and 100% pure ASCII
  1682.   to^M"
  1683.   send "  insure that you have the best possible email experience.^M"
  1684.   send
  1685.   "************************************************************^M"
  1686.   
  1687.   Now launch ZTerm and choose Edit Macros from the Macro menu.  Name
  1688.   the new macro sig, and type "(option-r)sig" in the Macro String
  1689.   field.  Now your sig is only a macro away.  You could also use the
  1690.   Run Script command under the Macro menu, but it wouldn't be as
  1691.   convenient.  Enjoy!
  1692.   
  1693.   [11.11]Other uses of scripts and macros
  1694.   
  1695.   Scripts and macros can eliminate a lot of needless typing.  The
  1696.   following is a script I concocted to speed up Kermit transfers on
  1697.   the VAX.  (I'm really looking forward to Kermit support in the next
  1698.   version of ZTerm!)
  1699.   
  1700.   Example:
  1701.   
  1702.   wait "kermit>" prompt
  1703.   send  "SET BLOCK_CHECK_TYPE THREE_CHARACTER_CRC_CCITT^M"
  1704.   wait "kermit>" prompt
  1705.   send "SET SEND PACKET_LENGTH 1000^M"
  1706.   wait "kermit>" prompt
  1707.   send "SET RECEIVE PACKET_LENGTH 1000^M"
  1708.   
  1709.   I use the following script to log on to the sumex-aim FTP site.
  1710.   
  1711.   send "FTP sumex-aim.stanford.edu^M"
  1712.   wait prompt "Username:"
  1713.   send "anonymous^M"
  1714.   wait prompt "Password:"
  1715.   send "ljones@utkvx.utk.edu^M"
  1716.   wait prompt "FTP>"
  1717.   send "cd info-mac^M"
  1718.   
  1719.   As in the example in 11.10, I could trigger these scripts with a
  1720.   macro or with the "run script" command.
  1721.   
  1722.   
  1723.   And finally, an Easter Egg.  Open a copy of ZTerm in ResEdit.
  1724.   Doubleclick on the STR resource, then doubleclick on the ID=0
  1725.   resource.  Inside you'll see a line from Monty Python.  Enjoy!
  1726.   
  1727.   
  1728.   Send in those corrections and tips!  And send Dave your shareware
  1729.   fee!
  1730.   
  1731.  
  1732.